home *** CD-ROM | disk | FTP | other *** search
/ Chip 2005 March / CMCD0305.ISO / Software / Demo / Itcomm / auscomp-itcommander-win5.exe / {pf} / Firebird / doc / README_embedded.txt < prev    next >
Encoding:
Text File  |  2004-02-20  |  3.3 KB  |  95 lines
  1. -----------------------------------------------------------
  2. Firebird 1.5 Embedded Server notes
  3. -----------------------------------------------------------
  4.  
  5. 1. GENERIC INFORMATION
  6.  
  7.   The embedded server is a fully functional server linked
  8.   as a dynamic library (fbembed.dll). It has exactly the
  9.   same features as the usual server and exports the
  10.   standard Firebird API entrypoints.
  11.  
  12. 2. ISSUES AND LIMITATIONS
  13.  
  14.   2.1. Registry
  15.  
  16.     The Firebird registry entries are ignored. The root
  17.     directory of the embedded server is the directory of
  18.     its binary file (library).
  19.  
  20.   2.2. Database access
  21.  
  22.     The embedded server can act as a true local server
  23.     accessing databases on a local machine, and as a remote
  24.     gateway which redirects all network calls to another
  25.     hosts (i.e. works as a client library). Note that you
  26.     cannot connect to the local standalone Firebird server
  27.     using the local connection string (without a host name).
  28.     It applies to IPC connections only, because they use
  29.     the same format of the connection string; but you can
  30.     connect to the local standalone server via TCP/IP localhost
  31.     loopback or via the named pipes protocol.
  32.  
  33.   2.3. Authentication and security
  34.  
  35.     The security database (namely security.fdb) is not used
  36.     in the embedded server and hence is not required. Any
  37.     user is able to attach to any database. Since both
  38.     the server and the client run in the same address space,
  39.     the security becomes just an agreement between both
  40.     sides which can be easily compromised.
  41.  
  42.     But note that SQL privileges are still checked.
  43.  
  44.   2.4. Compatibility
  45.  
  46.     You may run any number of applications with the embedded
  47.     server without any conflicts. Having IB/FB server running
  48.     is not a problem either.
  49.  
  50.     But you should be aware that you cannot access single
  51.     database from a number of the embedded servers
  52.     simultaneously, because they have SuperServer architecture
  53.     and hence exclusively lock attached databases.
  54.  
  55. 3. USAGE
  56.  
  57.   Just copy fbembed.dll into the directory with your
  58.   application. Then rename it to either fbclient.dll or
  59.   gds32.dll depending on your database connectivity software.
  60.   Then start your application and it will use the embedded
  61.   server as a client library and will be able to access
  62.   local datasases. You should also copy firebird.msg and
  63.   firebird.conf (if necessary) to the same directory.
  64.  
  65.   If external libraries are required for your application,
  66.   then you should have them separately. Most probably, it
  67.   will be INTL support (fbintl.dll) or UDF libraries. To
  68.   be able to use them, you should place them into the
  69.   directory tree which emulates the Firebird server one,
  70.   i.e. has subdirectories like /intl or /udf:
  71.  
  72.   c:\my_app\app.exe
  73.   c:\my_app\gds32.dll
  74.   c:\my_app\ib_util.dll
  75.   c:\my_app\firebird.conf
  76.   c:\my_app\firebird.msg
  77.   c:\my_app\intl\fbintl.dll
  78.   c:\my_app\udf\fbudf.dll
  79.  
  80.   If you want to place the Firebird files (excluding the
  81.   renamed fbembed.dll) in another directory, you need to
  82.   modify your firebird.conf and set RootDirectory to the
  83.   Firebird directory tree. Example:
  84.  
  85.   c:\my_app\app.exe
  86.   c:\my_app\gds32.dll
  87.   c:\my_app\ib_util.dll
  88.   c:\my_app\firebird.conf
  89.   d:\fb\firebird.msg
  90.   d:\fb\intl\fbintl.dll
  91.   d:\fb\udf\fbudf.dll
  92.  
  93.   firebird.conf:
  94.   RootDirectory = d:\fb
  95.